# Partially update emoji metadata

Updates emoji metadata fields without requiring file upload. Supports updating category, visibility and domain. Requires Emojis.Manage permission.

RBAC: requires Emojis.Manage

Endpoint: PATCH /api/v1/custom_emojis/{shortcode}
Version: 1.0
Security: header

## Path parameters:

  - `shortcode` (string, required)
    Emoji shortcode

## Request fields (application/json):

  - `category` (string,null)
    New category for the emoji

  - `visibleInPicker` (boolean,null)
    Visibility in emoji picker

  - `domain` (string,null)
    Domain for federated emoji metadata

## Response 200 fields (application/json):

  - `shortcode` (string, required)

  - `category` (string,null, required)

  - `url` (string, required)

  - `staticUrl` (string, required)

  - `visibleInPicker` (boolean, required)

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation